ValidatedIngredient

A validated provider of Ingredient

This does not store an ingredient, it stores an IngredientProvider, which lazily generates the ingredient only when requested.

Author

fzzyhmstrs

Since

0.2.0

Samples

import com.google.common.collect.ArrayListMultimap
import me.fzzyhmstrs.fzzy_config.validation.minecraft.ValidatedEntityAttribute
import me.fzzyhmstrs.fzzy_config.validation.minecraft.ValidatedIngredient
import me.fzzyhmstrs.fzzy_config.validation.minecraft.ValidatedTagKey
import net.minecraft.entity.attribute.EntityAttribute
import net.minecraft.entity.attribute.EntityAttributeModifier
import net.minecraft.recipe.Ingredient
import net.minecraft.registry.tag.BlockTags
import net.minecraft.registry.tag.ItemTags
import net.minecraft.util.Identifier

fun main() { 
   //sampleStart 
   // A validated Ingredient for a single item
val validatedIngredientItem = ValidatedIngredient(Identifier.of("oak_log"))

// A validated ingredient accepting a set of items
val validatedIngredientList = ValidatedIngredient(setOf(Identifier.of("oak_log"), Identifier.of("dark_oak_log")))

// A validated ingredient utilizing a tag
val validatedIngredientTag = ValidatedIngredient(ItemTags.LOGS_THAT_BURN)

//get the ingredient from the holder for use in Materials etc
val validatedIngredientIngredient: Ingredient = validatedIngredientItem.toIngredient()

//fields and sections have lang keys based on their "location" in the Config class graph.
//Lange key composition is as follows
//1. the namespace of the config id: (my_mod)
//2. the path of the config id: (my_mod.my_config)
//3. any parent ConfigSection field names as declared in-code: (my_mod.my_config.subSection)
//4. the setting field name as declared in-code: (my_mod.my_config.subSection.fieldName)
val fieldLang = """
{
    "_comment1": "the lang for an example 'fieldName' setting in a config inside section 'subSection'",
    "my_mod.my_config.subSection.fieldName": "Very Important Setting",
    "my_mod.my_config.subSection.fieldName.desc": "This very important setting is used in this very important way."
}
""" 
   //sampleEnd
}

Constructors

Link copied to clipboard
constructor(item: Identifier, itemPredicate: Predicate<Identifier>? = null, tagPredicate: Predicate<Identifier>? = null)

A validated provider of Ingredient

constructor(set: Set<Any>, itemPredicate: Predicate<Identifier>? = null, tagPredicate: Predicate<Identifier>? = null)

A validated provider of Ingredient

constructor(tag: TagKey<Item>, itemPredicate: Predicate<Identifier>? = null, tagPredicate: Predicate<Identifier>? = null)

A validated provider of Ingredient

Types

Link copied to clipboard
sealed interface IngredientProvider
Link copied to clipboard
Link copied to clipboard
class ListProvider(val ids: Set<Identifier>, val tags: Set<Identifier>) : ValidatedIngredient.IngredientProvider
Link copied to clipboard

Functions

Link copied to clipboard

updates the wrapped value. NOTE: this method will push updates to an UpdateManager, if any. For in-game updating consider validateAndSet

Link copied to clipboard

Attaches a listener to this field. This listener will be called any time the field is written to ("set"). accept, validateAndSet, setAndUpdate and so on will all call the listener.

Link copied to clipboard

Provides a Codec representing the value type of this validation, backed by the validators within as applicable

Link copied to clipboard

Creates a deep copy of the stored value and returns it

Link copied to clipboard
open fun description(fallback: String? = null): MutableText

The translated Text description from the descriptionKey. Falls back to an empty string so no tooltip is rendered.

Link copied to clipboard
open override fun descriptionKey(): String

translation key of this Translatable's description. the "description" in-game, the descriptions Enchantment Descriptions adds to enchantment tooltips are a good example.

Link copied to clipboard
open fun flags(): Byte
Link copied to clipboard

supplies the wrapped value

Link copied to clipboard

Provides this validations default value

Link copied to clipboard

Whether this Translatable has a valid description

Link copied to clipboard
open override fun hasFlag(flag: EntryFlag.Flag): Boolean
Link copied to clipboard

Whether this Translatable has a valid translation

Link copied to clipboard

creates a deep copy of this ValidatedIngredient return ValidatedIngredient wrapping a deep copy of the currently stored ingredient provider as well as predicates, if any

Link copied to clipboard

Maps this validation to a new convertible type. The default value will be applied from this delegates current storedValue

Maps this validation to a new convertible type.

Link copied to clipboard

Convert this field to a ValidatedCondition using the provided validation as a supplier. The provided condition (and any others you append) must pass for the stored value to be provided, otherwise the fallback will be supplied.

Convert this field to a ValidatedCondition. The provided condition (and any others you append) must pass for the stored value to be provided, otherwise the fallback will be supplied.

Convert this field to a ValidatedCondition using the provided scope with a default boolean provider. The provided condition (and any others you append) must pass for the stored value to be provided, otherwise the fallback will be supplied. The provided scope must point to a valid boolean config scope otherwise the initial condition will never pass.

Link copied to clipboard
fun toIngredient(): Ingredient

Supplies the Ingredient from this ValidatedIngredients Provider

Link copied to clipboard

wraps the provided values into a ValidatedList with this field as validation

wraps the provided collection into a ValidatedList with this field as validation

Link copied to clipboard

wraps the provided values into a ValidatedSet with this field as validation

wraps the provided collection into a ValidatedList with this field as validation

Link copied to clipboard
open override fun translation(fallback: String?): MutableText

The translated Text name from the translationKey. Falls back to the implementing classes Simple Name (non-translated)

Link copied to clipboard
open override fun translationKey(): String

translation key of this Translatable. the "name" in-game

Link copied to clipboard
fun trySerialize(input: Any?, errorBuilder: MutableList<String>, flags: Byte): TomlElement?
Link copied to clipboard
open override fun trySet(input: Any?)
Link copied to clipboard
open fun update(updateMessage: Text)
Link copied to clipboard

A setter method for the storedValue that first validates the value being set and then stores the post-validation result.

Updates this ValidatedIngredient with a new multi-item Ingredient

fun validateAndSet(tag: TagKey<Item>): ValidatedIngredient

Updates this ValidatedIngredient with a new tag Ingredient

fun validateAndSet(identifier: Identifier): ValidatedIngredient

Updates this ValidatedIngredient with a new single-item Ingredient

Link copied to clipboard
open fun widgetAndTooltipEntry(choicePredicate: ChoiceValidator<ValidatedIngredient.IngredientProvider> = ChoiceValidator.any()): ClickableWidget